ActiveX Control Interface Wizard

Helps you create the public interface for a Visual Basic-generated ActiveX control after you have created your user interface.

Note   The ActiveX Control Interface Wizard helps you create underlying code for the public interface of your ActiveX control, but it does not create the user interface. You must create an ActiveX control with the interface elements that you want before you use the ActiveX Control Interface Wizard.

Use the ActiveX Control Interface wizard, to:

•	Add standard property, method, and event names for your user control.

•	Add new custom property, method, and event names for your user control.

•	Define attributes for the public property, method, and event names.

The ActiveX Control Interface Wizard has the following steps:

Introduction

Select a Control   Only appears when you have more than one user control in the current project group.

Select Interface Members

Create Custom Interface Members

Set Mapping

Set Attributes

Finished


ActiveX Control Interface Wizard - Create Custom Interface Members
ActiveX Control Interface Wizard — Create Custom Interface Members

Allows you to add your own custom property, method, and event names to the user control. If the user control already has code in its Code window, the names of custom properties, methods, and events will be shown in the My Custom Members listbox.

Wizard Options

My Custom Members   Lists the available custom properties, methods, and events that you want to add.

New   Displays the Add Custom Member dialog box so you can add new custom property, method, and event names.

Delete   Deletes the selected property, method, or event. You can only delete one member at a time.

Edit   Displays the Edit Custom Member dialog box so you can edit the selected property, method, or event.

Help   Displays the help topic for this step. You can also press F1 for help.

Cancel   Cancels your previous actions and closes the ActiveX Control Interface Wizard.

Back   Moves you to the previous step.

Next   Moves you to the next step.

Finish   Unavailable because you have not provided enough information for the ActiveX Control Interface Wizard to create an ActiveX control using default values.


ActiveX Control Interface Wizard - Finished!
ActiveX Control Interface Wizard — Finished!

Creates ActiveX control using the options you chose and allows you to obtain an summary report that contains information on additional steps to take.

Wizard Options

Do you want to:

View Summary Report — Generates a summary report with suggestions for testing and debugging your user control.

Help   Displays the help topic for this step. You can also press F1 for help.

Cancel   Cancels your previous actions and closes the ActiveX Control Interface Wizard.

Back   Moves you to the previous step.

Next   Disabled in this step.

Finish   Creates an ActiveX control based on the settings you selected.


ActiveX Control Interface Wizard - Introduction
ActiveX Control Interface Wizard — Introduction

The ActiveX Control Interface Wizard helps you to create ActiveX control interfaces. You can add the properties, methods, and events you want and set their attributes.

Wizard Options

Skip this screen in the future   When selected, the ActiveX Control Interface Wizard will not show the Introduction screen the next time you start it.

If you want to see this screen in the future, click the Back button on the first step of the wizard.

Help   Displays the help topic for this step. You can also press F1 for help.

Cancel   Cancels your previous actions and closes the ActiveX Control Interface Wizard.

Back   Disabled in this step.

Next   Moves you to the next step.

Finish   Unavailable because you have not provided enough information for the ActiveX Control Interface Wizard to create an ActiveX control using default values.


ActiveX Control Interface Wizard - Select Interface Members
ActiveX Control Interface Wizard — Select Interface Members

Allows you to select the property, method, and event names you want in your user control.

Wizard Options

Available Names   Displays a list of the available property, method, and event names.

Selected Names   Displays a list of the property, method, and event names that you want to use in your control. The property, method, and event names initially listed are those commonly supported by controls. If your user control already has code in its Code window, the items shown in the Selected Names listbox are those properties, events, and methods which already exist in your control.

Moves the selected property, method, and event names in the Available Names list to the Selected Names list, indicating you want to include those property, method, and event names in your user control. You can choose one or more properties, methods, or events.

To choose more than one property, method, or event, click the properties, methods, or events you want, or click a property, method, or event, hold down SHIFT, and click the last member in the list.

Moves all of the property, method, and event names in the Available Names list to the Selected Names list.

Moves the selected property, method, and event names in the Selected Names list to the Available Names list. You can choose one or more properties, methods, or events.

To choose more than one property, method, or event, click the properties, methods, or events you want, or click a property, method, or event, hold down SHIFT, and click the last member in the list.

Note   If you use the SHIFT and click method, the list of property, method, and event names you want must be contiguous. Otherwise, use the CTRL and click method to select multiple, non-contiguous property, method, and event names.

Moves all of the property, method, and event names in the Selected Names list to the Available Names list.

Help   Displays the help topic for this step. You can also press F1 for help.

Cancel   Cancels your previous actions and closes the ActiveX Control Interface Wizard.

Back   Moves you to the previous step.

Next   Moves you to the next step.

Finish   Unavailable because you have not provided enough information for the ActiveX Control Interface Wizard to create an ActiveX control using default values.


ActiveX Control Interface Wizard - Set Attributes
ActiveX Control Interface Wizard — Set Attributes

Allows you to set the attributes for any property, method, and event names that you did not map in the previous step.

Wizard Options

Public Name   Lists the public property, method, and event names that have not been previously mapped.

Description   Allows you to type in, or displays a brief description of the selected property, method, or event.

Attribute Information

Data Type or Return Type — Displays all available data types for the selected property or return types for the selected method. Not available for events.

Default Value — Allows you to enter a default value for the property or method. Not available for events.

Run Time — Allows you to select the run time behavior for the selected property or method. Not available for events.

•	Read/Write

•	Read Only

•	Write Only

•	Not Available

Design Time — Allows you to select the design time behavior for the selected property or method. Not available for events.

•	Read/Write

•	Read Only

•	Not Available

Arguments — Allows you to enter or select custom arguments for the selected property, method, or event.

Help   Displays the help topic for this step. You can also press F1 for help.

Cancel   Cancels your previous actions and closes the ActiveX Control Interface Wizard.

Back   Moves you to the previous step.

Next   Moves you to the next step.

Finish   Creates an ActiveX control with the settings you selected and displays a confirmation dialog. In the confirmation dialog box, you can choose to not have the dialog box appear when you run the ActiveX Control Interface Wizard again.


ActiveX Control Interface Wizard - Set Mapping
ActiveX Control Interface Wizard — Set Mapping

Allows you to map the functionality of the public property, method, and event names to underlying private property, method, and event names on the user control and constituent controls.

Wizard Options

Public Name List   Lists the public property, method, and event names. You can map multiple property, method, and event names to one user or constituent control by selecting them and then choosing the control.

To choose more than one property, method, or event name, hold down CTRL and click the property, method, or event names you want, or click a property, method, or event name, hold down SHIFT, and click the last member in the list.

Maps to   Allows you to map the functionality of public property, method, and event names to private property, method, and event names on your user control and constituent controls.

Control — Lists the user control and all constituent controls. The default is (None).

Member — Lists all of the property, method, and event names for the controls selected in the Control list.

Note   For example, if you create a BackColor property and want it to refer to the user control's BackColor property, you would select UserControl in the Control box and BackColor in the Member box.

Help   Displays the help topic for this step. You can also press F1 for help.

Cancel   Cancels your previous actions and closes the ActiveX Control Interface Wizard.

Back   Moves you to the previous step.

Next   Moves you to the next step.

Finish   Unavailable because you have not provided enough information for the ActiveX Control Interface Wizard to create an ActiveX control using default values.


Add Custom Member and Edit Custom Member Dialog Boxes

Allows you to add and edit selected custom property, method, and event names.

Dialog Box Options

Name   Lists the name of the selected custom property, method, or event.

Type

Property — Adds or changes the current custom member to a property.

Method — Adds or changes the current custom member to a method.

Event — Adds or changes the current custom member to an event.

OK   Accepts the changes.

Cancel   Cancels your changes and closes the dialog box.


ActiveX Control Interface Wizard - Select a Control
ActiveX Control Interface Wizard — Select a Control

Allows you to choose the user control for which you want to create property, method, and event names.

Note   Only appears when you have more than one user control in the current project group.

Wizard Options

User Control List   Lists the user controls in your project group with the project name followed by a colon and the name of the control.

Help   Displays the help topic for this step. You can also press F1 for help.

Cancel   Cancels your previous actions and closes the ActiveX Control Interface Wizard.

Back   Moves you to the previous step.

Next   Moves you to the next step.

Finish   Unavailable because you have not provided enough information for the ActiveX Control Interface Wizard to create an ActiveX control using default values.


Available Propery, Method, and Event Names
Available Property, Method, and Event Names

The ActiveX Control Interface Wizard interrogates the user control and all constituent controls on the user control, and populates the Available Names list with all of the public properties, methods, and events that it finds. Duplicate member names are displayed one time only. For example it you have a BorderStyle property for the user control and a constituent control, you will see BorderStyle property only once in the Available Names list. You use the Set Mapping step to map the BorderStyle property to the control you want.

For a variety of reasons, not all of the property, method and event names are displayed in the Available Names list of the ActiveX Control Interface Wizard.

The table below lists the members that are not displayed or get special handling in the ActiveX Control Interface Wizard.

Category	Property, Method, or Event Name	Status
Extender Properties, Methods, and Events	DragIcon, DragMode, Height, HelpContextID, Index, Left, Name, TabIndex, TabStop, Tag, ToolTipText, Top, Visible, WhatsThisHelpID, Width, SetFocus, DragOver, DragDrop, GotFocus, LostFocus.	Not displayed because they are provided by the control's Extender object.
Special Methods	Circle, Line, PSet, Point, Scale .	Get special handling because they have backward compatibility issues related to them that affect their syntax.
Color List	BackColor, ForeColor, FillColor	Get special handling because they are automatically set to OLE_COLOR as a data type.
Banned Properties, Methods, and Events	AccessKeyPress, AccessKeys, Ambient, AmbientChanged, CanPropertyChange, ContainedControls, Count, EditAtDesignTime, EnterFocus, EventsFrozen, ExitFocus, Extender, InitProperties,  Initialize, KeyPreview, ParentControls, PropertyChanged, PropertyPages, ReadProperties WriteProperties, Terminate	Not displayed because they either cannot be used, or would not have any relevance if used outside the user control.